Skip to content

Conversation

@neroyang22
Copy link
Contributor

@neroyang22 neroyang22 commented Jan 9, 2026

Summary by CodeRabbit

  • Bug Fixes

    • Fixed CodeBuddy slash-command frontmatter: added missing fields, replaced category/tags with argument-hint, and enforced square-bracket argument format (e.g., [change-id]) across proposal/apply/archive templates.
    • Quoted descriptions and standardized YAML frontmatter structure for generated slash commands.
  • Documentation

    • Updated init/update specs and task checklist to document generation/refresh rules, frontmatter requirements, and preservation of user customizations.

✏️ Tip: You can customize this high-level summary in your review settings.

@neroyang22 neroyang22 requested a review from TabishB as a code owner January 9, 2026 12:41
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 9, 2026

📝 Walkthrough

Walkthrough

Replaces CodeBuddy slash-command frontmatter fields: removes category/tags, adds argument-hint (square-bracket format), ensures YAML description values are quoted, and adds missing frontmatter for proposal/apply/archive; updates specs, tasks, and implementation templates accordingly.

Changes

Cohort / File(s) Summary
Implementation
src/core/configurators/slash/codebuddy.ts
Updated FRONTMATTER templates: wrapped description values in quotes and added argument-hint for proposal, apply, and archive commands.
Active Spec Updates
openspec/specs/cli-init/spec.md, openspec/specs/cli-update/spec.md
Require CodeBuddy-compatible YAML frontmatter with quoted description and argument-hint using square-bracket parameter format (e.g., [change-id]); preserves other tools' behaviors.
Change Proposal & Task List
openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md, openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
New proposal and checklist: replace category/tags with argument-hint, add missing fields, ensure consistency across commands, and test via openspec init / openspec update.
Archived Specs (detailed requirements)
openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md, openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
Expanded per-tool generation/update requirements documenting CodeBuddy YAML frontmatter, argument-hint formatting, content templates, and file placement/markers across tools.
Tests
test/core/init.test.ts
Adjusted expected generated content: descriptions quoted and argument-hint lines added/replacing prior category entries where applicable.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • TabishB

Poem

🐇 I hopped through YAML, nibbled tags away,
Bracketed hints now guide the play,
Quoted descriptions warm and bright,
Three commands hop into the light,
✨🐰

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: modifying CodeBuddy slash command frontmatter to use argument-hint instead of category/tags.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@vibe-kanban-cloud
Copy link

Review Complete

Your review story is ready!

View Story

Comment !reviewfast on this PR to re-generate the story.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In
@openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md:
- Line 8: The proposal says to remove the `name` frontmatter field but the
CodeBuddy configurator in codebuddy.ts still defines `name`; remove the `name`
property occurrences from the exported configurator/object in
src/core/configurators/slash/codebuddy.ts (the three places where `name` is set)
so the code matches the proposal, then run formatting/linting and update any
tests or documentation that referenced that field; alternatively, if keeping
`name` was intentional, update the proposal text to reflect that instead.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 533cb0f and 880d992.

📒 Files selected for processing (7)
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
  • openspec/specs/cli-init/spec.md
  • openspec/specs/cli-update/spec.md
  • src/core/configurators/slash/codebuddy.ts
🧰 Additional context used
📓 Path-based instructions (3)
openspec/changes/**/*.md

📄 CodeRabbit inference engine (openspec/AGENTS.md)

Scaffold proposal using proposal.md, tasks.md, optional design.md, and delta specs under openspec/changes/<id>/

Files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
openspec/changes/**/specs/**/spec.md

📄 CodeRabbit inference engine (openspec/AGENTS.md)

openspec/changes/**/specs/**/spec.md: Use ## ADDED|MODIFIED|REMOVED|RENAMED Requirements headers in spec delta files
Include at least one #### Scenario: per requirement in spec delta files
Use #### Scenario: Name format (4 hashtags) for scenario headers, not bullets or bold text
Use ## ADDED Requirements for new orthogonal capabilities that can stand alone; use ## MODIFIED Requirements for behavior changes of existing requirements
When using MODIFIED Requirements, paste the full requirement block including header and all scenarios

Files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
openspec/specs/**/spec.md

📄 CodeRabbit inference engine (openspec/AGENTS.md)

Use SHALL/MUST for normative requirements in spec files; avoid should/may unless intentionally non-normative

Files:

  • openspec/specs/cli-update/spec.md
  • openspec/specs/cli-init/spec.md
🧠 Learnings (14)
📓 Common learnings
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : Use `## ADDED|MODIFIED|REMOVED|RENAMED Requirements` headers in spec delta files

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
  • openspec/specs/cli-init/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : Use `## ADDED Requirements` for new orthogonal capabilities that can stand alone; use `## MODIFIED Requirements` for behavior changes of existing requirements

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/*.md : Scaffold proposal using `proposal.md`, `tasks.md`, optional `design.md`, and delta specs under `openspec/changes/<id>/`

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
  • src/core/configurators/slash/codebuddy.ts
  • openspec/specs/cli-init/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
  • src/core/configurators/slash/codebuddy.ts
📚 Learning: 2025-11-25T01:08:02.839Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:02.839Z
Learning: Use `@/openspec/AGENTS.md` to learn how to create and apply change proposals, spec format and conventions, and project structure and guidelines

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : Include at least one `#### Scenario:` per requirement in spec delta files

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Create `design.md` only when needed: cross-cutting changes, new external dependencies, significant data model changes, security/performance complexity, or pre-coding ambiguity

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
📚 Learning: 2025-11-25T01:08:02.839Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:02.839Z
Learning: Always open `@/openspec/AGENTS.md` when the request mentions planning or proposals (words like proposal, spec, change, plan), introduces new capabilities, breaking changes, architecture shifts, or performance/security work, or sounds ambiguous and needs the authoritative spec before coding

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : When using MODIFIED Requirements, paste the full requirement block including header and all scenarios

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/specs/**/spec.md : Use SHALL/MUST for normative requirements in spec files; avoid should/may unless intentionally non-normative

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : Use `#### Scenario: Name` format (4 hashtags) for scenario headers, not bullets or bold text

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md
  • openspec/specs/cli-update/spec.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/tasks.md : Ensure `tasks.md` contains implementation checklist with numbered sections and checkbox items

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Check `openspec/project.md` for project conventions before creating specs

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md
🔇 Additional comments (10)
src/core/configurators/slash/codebuddy.ts (4)

13-14: LGTM! Frontmatter updates align with CodeBuddy requirements.

The addition of quoted description and argument-hint field with the square bracket format improves consistency with CodeBuddy's documentation.


18-19: LGTM! Consistent frontmatter structure.

The apply command now includes proper argument-hint with the correct [change-id] placeholder format.


23-24: LGTM! Archive command frontmatter is consistent.

The archive command follows the same pattern with quoted description and proper argument-hint field.


10-26: The name field should be retained.

Tests explicitly validate that CodeBuddy slash command files must contain the name field. The test at test/core/init.test.ts:1123 asserts expect(proposalContent).toContain('name: OpenSpec: Proposal');, confirming that the field is expected in the generated output. Similar assertions validate the name field for all three commands (proposal, apply, archive). Multiple other tools (Claude, Crush, Qoder) also include and test for the name field, indicating it is part of the expected slash command frontmatter format. The current implementation correctly retains it.

openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md (1)

1-17: Proposal structure follows best practices.

The proposal includes all required sections (Why, What Changes, Impact) as per coding guidelines. The rationale is clear and the impact is well-documented.

Based on learnings, the proposal correctly includes Why (1-2 sentences), What Changes (bullet list), and Impact (affected specs and code).

openspec/specs/cli-init/spec.md (1)

188-192: LGTM! Spec correctly documents CodeBuddy frontmatter requirements.

The requirements correctly specify CodeBuddy-compatible YAML frontmatter with description and argument-hint fields, and the square bracket format for parameters. This aligns with the implementation in src/core/configurators/slash/codebuddy.ts.

As per coding guidelines, the spec uses SHALL for normative requirements appropriately.

openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/tasks.md (1)

1-6: LGTM! Tasks file follows conventions.

The tasks file includes numbered sections with checkbox items as expected. All implementation tasks are marked complete and align with the changes described in the proposal.

Based on learnings, the tasks.md correctly contains an implementation checklist with numbered sections and checkbox items.

openspec/specs/cli-update/spec.md (1)

66-71: LGTM! Update spec aligns with init spec requirements.

The scenario correctly documents the update behavior for CodeBuddy slash commands, including the use of shared templates with YAML frontmatter, square bracket format for argument-hint, and preservation of user customizations. This is consistent with the changes in cli-init/spec.md.

As per coding guidelines, the spec uses SHALL for normative requirements appropriately.

openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-update/spec.md (1)

1-56: Spec structure and CodeBuddy frontmatter requirements are well-defined.

The MODIFIED Requirements section properly documents the slash-command update behavior across all tools, with consistent scenario formatting and normative language. The CodeBuddy scenario (lines 17-21) and Factory Droid scenario (lines 40-45) correctly specify the YAML frontmatter structure with description and argument-hint fields, and the square bracket parameter format aligns with the PR objective of updating CodeBuddy frontmatter fields.

openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/specs/cli-init/spec.md (1)

1-75: Spec comprehensively documents initialization requirements across 10 tools with proper CodeBuddy frontmatter specification.

The MODIFIED Requirements properly define the openspec init behavior with well-formatted scenarios. The CodeBuddy scenario (lines 19-24) correctly specifies the new frontmatter structure with description and argument-hint fields using square bracket format, which aligns with the PR objective. The inclusion of two additional tools (Kilo Code and Codex) relative to the cli-update spec is appropriate, as initialization must support a broader set of tools than the update command refreshes. The Factory Droid scenario's inclusion of $ARGUMENTS placeholder and Codex's use of $1 placeholder correctly reflect tool-specific requirements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (3)
openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md (3)

1-3: Condense the Why section to 1-2 sentences.

The Why section exceeds the guideline of 1-2 sentences. The current paragraph combines problem identification, contextual comparison, and documentation review into a single long sentence. Consider splitting or condensing to focus on the core rationale.

Based on learnings: the proposal.md should include Why section with 1-2 sentences.

✏️ Proposed revision
## Why

-CodeBuddy slash command configurator currently uses inconsistent frontmatter fields compared to other tools. It uses `category` and `tags` fields (like Crush) but should use `argument-hint` field (like Factory, Auggie, and Codex) for better consistency. Additionally, the `proposal` command is missing frontmatter fields entirely. After reviewing CodeBuddy's official documentation, the correct format should use `description` and `argument-hint` fields with square bracket parameter format.
+CodeBuddy uses inconsistent frontmatter fields compared to other tools (Factory, Auggie, Codex). To align with CodeBuddy's official documentation and improve consistency, we need to replace `category`/`tags` with `argument-hint` and add missing frontmatter fields to the `proposal` command.

5-10: Mark breaking changes in the What Changes section.

The bullet list should explicitly indicate which changes are breaking. Replacing category and tags with argument-hint is a breaking change for existing CodeBuddy configurations. Add a marker (e.g., ⚠️ BREAKING or similar notation) to affected items.

Based on learnings: the proposal.md should include What Changes as a bullet list with breaking change markers.

✏️ Proposed revision
## What Changes

-- Replace `category` and `tags` fields with `argument-hint` field in CodeBuddy frontmatter
+- ⚠️ BREAKING: Replace `category` and `tags` fields with `argument-hint` field in CodeBuddy frontmatter
- Add missing frontmatter fields to the `proposal` command
- Use correct square bracket format for `argument-hint` parameters (e.g., `[change-id]`)
- Ensure consistency with CodeBuddy's official documentation

12-16: Expand the Impact section with implications.

While the section correctly identifies affected specs and code, consider adding detail on the implications: how these changes affect CodeBuddy users, what migration steps may be required, and any backward compatibility considerations.

✏️ Suggested expansion
## Impact

- Affected specs: cli-init, cli-update
- Affected code: `src/core/configurators/slash/codebuddy.ts`
- CodeBuddy users will get proper argument hints in the correct format for slash commands
+- Requires updates to existing CodeBuddy configurations using `category`/`tags` fields
+- Existing templates must be migrated to use `argument-hint` format with square brackets
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 880d992 and a49f340.

📒 Files selected for processing (1)
  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
🧰 Additional context used
📓 Path-based instructions (1)
openspec/changes/**/*.md

📄 CodeRabbit inference engine (openspec/AGENTS.md)

Scaffold proposal using proposal.md, tasks.md, optional design.md, and delta specs under openspec/changes/<id>/

Files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
🧠 Learnings (6)
📓 Common learnings
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/*.md : Scaffold proposal using `proposal.md`, `tasks.md`, optional `design.md`, and delta specs under `openspec/changes/<id>/`
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/*.md : Scaffold proposal using `proposal.md`, `tasks.md`, optional `design.md`, and delta specs under `openspec/changes/<id>/`

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
📚 Learning: 2025-11-25T01:08:02.839Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:02.839Z
Learning: Use `@/openspec/AGENTS.md` to learn how to create and apply change proposals, spec format and conventions, and project structure and guidelines

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/specs/**/spec.md : Use `## ADDED|MODIFIED|REMOVED|RENAMED Requirements` headers in spec delta files

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Create `design.md` only when needed: cross-cutting changes, new external dependencies, significant data model changes, security/performance complexity, or pre-coding ambiguity

Applied to files:

  • openspec/changes/archive/2026-01-09-fix-codebuddy-frontmatter-fields/proposal.md

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
test/core/init.test.ts (1)

1099-1140: Add test assertions for argument-hint on apply and archive commands.

The test checks for argument-hint on the proposal command (line 1125) but omits similar checks for apply and archive. Other tool tests (Factory, Codex, Auggie, CoStrict) verify argument-hint on all three commands. Given the PR adds frontmatter for all three commands, ensure test coverage is complete.

📝 Suggested test additions

Add after line 1133:

 expect(applyContent).toContain('description: "Implement an approved OpenSpec change and keep tasks in sync."');
+expect(applyContent).toContain('argument-hint: "[change-id]"');
 expect(applyContent).toContain('Work through tasks sequentially');

Add after line 1138:

 expect(archiveContent).toContain('description: "Archive a deployed OpenSpec change and update specs."');
+expect(archiveContent).toContain('argument-hint: "[change-id]"');
 expect(archiveContent).toContain('openspec archive <id> --yes');
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a49f340 and 3d2f995.

📒 Files selected for processing (1)
  • test/core/init.test.ts
🧰 Additional context used
🧠 Learnings (3)
📓 Common learnings
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/*.md : Scaffold proposal using `proposal.md`, `tasks.md`, optional `design.md`, and delta specs under `openspec/changes/<id>/`
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/*/proposal.md : Ensure `proposal.md` includes sections: Why (1-2 sentences), What Changes (bullet list with breaking change markers), and Impact (affected specs and code)

Applied to files:

  • test/core/init.test.ts
📚 Learning: 2025-11-25T01:08:19.004Z
Learnt from: CR
Repo: Fission-AI/OpenSpec PR: 0
File: openspec/AGENTS.md:0-0
Timestamp: 2025-11-25T01:08:19.004Z
Learning: Applies to openspec/changes/**/*.md : Scaffold proposal using `proposal.md`, `tasks.md`, optional `design.md`, and delta specs under `openspec/changes/<id>/`

Applied to files:

  • test/core/init.test.ts

@TabishB TabishB merged commit 3f67deb into Fission-AI:main Jan 9, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants